home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 2 / ACE CD 2.iso / FILES / DOCS / SBASEP4D.LHA / SuperBasePersonal < prev    next >
Text File  |  1994-11-27  |  37KB  |  799 lines

  1.             SUPERBASE PERSONAL
  2.  
  3. Ported from an AMIGA disk to the ST and back again. Edited by Parasite.
  4.  
  5.  
  6. PART 1
  7.  
  8. WELCOME TO SUPERBASE   
  9.  
  10. This Introductory session with Superbase will give you an understanding of
  11. how to perform some of the basic database operations of the Superbase system.
  12. Some more complex functions are explained in the section Working with
  13. Superbase.
  14.  
  15. We'll assume you know how to do a number of things which are either essential
  16. to the ST operating system or common to almost all ST programs:
  17.  
  18.  Switching on the power.
  19.  Using the mouse to point, click on Icons or menu items, and drag  Icons or
  20.    windows around the screen.
  21.  Resizing windows.
  22.  
  23. If you don't know how to do any of these, refer to the ST User Guides.
  24. In addition, you should have a thorough understand of elementary file
  25. operations, such as copying files, renaming files and deleting files.
  26.  
  27. THE SUPERBASE MENUS
  28.  
  29. The Superbase menus are obtained in the same way as for all ST GEM based
  30. programs.  Move the mouse to the title-bar and the menu will appear.
  31. Simply click on the appropriate item.
  32.  
  33. GHOSTED ITEMS
  34.  
  35. A standard intuition feature is the "ghosting" of menu items that are
  36. temporarily unavailable.  We use this feature in Superbase, most obviously
  37. during this start up phase when no file is open.
  38.  
  39. To see this, move the pointer to the menu bar, and move the pointer across
  40. until it's on the work Record.  You'll see that all the items on this menu
  41. appear to be faint,  as if only half the dots that make up each letter were
  42. being used.  If you try to select a ghosted item, nothing will happen.
  43. A quick look at the Control Panel at the bottom of the screen will reveal
  44. the most of the control buttons are also ghosted while no file is open.
  45.  
  46. OPENING A FILE
  47.  
  48. If you look at the top left-hand corner of the screen you will see a message
  49. that reads "Superbase: Please open a file".  You always see this message
  50. when you start Superbase up, or when there is no file open.  Since you can't
  51. do any work without a file, let's open one and take a look at it.
  52.  
  53. Files can only be opened from the Project menu.  This is the first menu on
  54. the menu bar.
  55.  
  56. Move the mouse pointer to the top of the screen so that it highlights the
  57. work Project. As you do this the Project menu appears. The item you
  58. want is open.  Move the pointer down the menu, and highlight open. As you
  59. do so, you'll see four subitems appear to the right, three of which,
  60. Fields, Index, and Query are ghosted.  The only one available is File
  61. which is the one you want to select.  So, keeping Open highlighted,
  62. move the pointer slowly to the right until the File subitem is also
  63. highlighted.  Now, press the left mouse button, and the item is selected.
  64. All menu items are selected in the same way, and we won't give detailed
  65. instructions for the dozens of menu selections discussed elsewhere in the
  66. manual.
  67.  
  68. SUPERBASE REQUESTERS
  69.  
  70. Superbase now requestes the name of the file you wish to open.  Requesters
  71. like this one (some are more complicated) are used in most Superbase
  72. operations.  They also communicate messages to the user.  They are
  73. known as requesters because their function is to request specific action
  74. from the user. Usually the action involves making selections by clicking
  75. the mouse or typing in a number of a text value of some kind.
  76.  
  77. Many requesters show a panel that contains a list of items such as file
  78. name or field names.  The panel may be only a few lines long, so there may
  79. be more files or fields than can be shown at one time.  If there's
  80. a gap at the bottom of the scroll bar there are more items to be viewed.
  81. You can show them by dragging down the scroll bar at the right of the
  82. panel, or by clicking on the downwards pointing arrow gadget below the
  83. scroll bar. 
  84.  
  85. One very important fact about requesters is that you must respond to them
  86. before you can do anything else. Most requesters have a Cancel button.
  87. Clicking on this returns you to whatever you were doing previously. If
  88. there's no Cancel button there is certain to be an OK button, and you can
  89. safely click on this once you've read the requester.
  90.  
  91. Many Superbase requesters include a Clear button. This has the effect of
  92. removing anything that's in the Selection Box, and can be used at any time.
  93.  
  94. CHOOSING THE ADDRESSES FILE
  95.  
  96. Move the pointer into the panel which contains a list of file names.
  97. Move it  over the file name Addresses.  This is the demonstration file
  98. you'll be using  for the rest of this session.  Using the left-hand button,
  99. click once on the name Addresses. Superbase copies the name of the file
  100. you've selected into  the Selection Box -- that's the box underneath the
  101. panel of tile names.  (If  you see the wrong file name in the box, move the
  102. pointer carefully onto the  right file name, and click again.)  Once
  103. you've selected the file, move the pointer onto the OK button and click
  104. once. Superbase now opens the Addresses file.
  105.  
  106. THE MAIN DISPLAY
  107.  
  108. When Superbase opens a file from the start up screen, it automatically reads
  109. the first record in the file and shows it on the Main Display screen.
  110. You'll see the name of the file appear on the title bar at the top of the
  111. window, followed by the name of the field on which the file is currently
  112. indexed.
  113.  
  114. The Main Display is Superbase's permanent window onto your database. It's
  115. like a large worksheet, 273 colulmns across; the number of lines you can see
  116. depends on the size of your window.  Surperbase uses the Main Display
  117. to show you the records in the current file, as well as the results of some
  118. other operations. At the bottom of the Main Display is the Control Panel,
  119. which we'll be looking at in a minute.
  120.  
  121. On the Main Display, the field names for each record in the Addresses file
  122. appear down the left-hand side of the screen. The data for each field is
  123. displayed to the right of its field name.  If the data for a field is
  124. wider than the window, it extends off to the right. You can bring it into
  125. view using the scroll bar at the bottom of the window.
  126.  
  127. Remember that if there were more fields in the record than you could see,
  128. you could view them by dragging the scroll bar at the right of the window
  129. downwards, or by clicking on the downward pointing arrow.
  130.  
  131. RECORD VIEW, FORM VIEW AND TABLE VIEW
  132.  
  133. The record format you're looking at now is only one of the three possible
  134. ways of looking at your file.  It's called Record View. This view shows
  135. the records one at a time, restricting the format by keeping the field
  136. names on the left and limiting you to one field per line. This restriction
  137. allows records to be scrolled up and down the screen with the Control
  138. Panel buttons.
  139.  
  140. In Form View, you also see one record at a time.  Each record is like a
  141. form or page and, as you'll see later, you can drag the fields around to
  142. create a worksheet desinged to suit your application.
  143.  
  144. The third display format is Table View.  This displays the field names
  145. across the top of the screen with the data appearing in rows and columns,
  146. each record occupying one line.
  147.  
  148. SWITCHING TO TABLE VIEW
  149.  
  150. Select Table View from the Set Menu.  You will see the field names appear
  151. across the top of the screen. The same record is shown, but each item of
  152. data appears underneath its field name.  As with Form View, there are ways
  153. of changing this row and colulmn display to suit your own preferences which
  154. we'll explain later.
  155.  
  156. SCROLLING THE SCREEN
  157.  
  158. While you are viewing your record in Table View you will notice that the
  159. field names do not all fit onto the screen. The fileds to the right can be
  160. viewed using the arrow at the right of the bottom scroll bar. Move the
  161. pointer onto this arrow, and click on it once. The display shifts five
  162. columns to the left. Click once on the left-hand arrow to shift right
  163. and restore the display. If you want to shift the display by larger areas,
  164. drag the bottom scroll bar with the mouse.
  165.  
  166. CONTROL PANEL
  167.  
  168. Now that you've opened a file, and discovered how to change the way in
  169. which records are displayed on the screen, let's look at the Control Panel.
  170. This is your means of controlling the main display.  As you can see there
  171. are 12 buttons, most of them modelled on the controls for a video cassette
  172. or tape recorder, so you should find these conventions easy to learn and
  173. remember.
  174.  
  175. Each button has a special purpose, and together they fall into three groups.
  176. On the left are the Pause and Stop buttons. Followed by seven buttons for
  177. browsing through the file.  On the right are three special purpose
  178. buttons which we'll examine later. The functions of some controls are more
  179. intuitively obvious than others, so we'll take a look at the first nine
  180. now, one by one.  Make sure you've set Table View for this exercise.
  181.  
  182.  ^ Current Record: This button is used to display the current record.
  183. When Table View has put a lot of records on the screen it can be helpful
  184. to select the current record as the top record in the display. Also, you
  185. can only Edit the current record, and this button is a useful way of
  186. ensuring that you've got the right record. If you click on this button
  187. you will notice that Superbase clears the screen and then displays the
  188. current record.
  189.  
  190.  > Next Record: Allows you to view the next record in the file. The order
  191. in which the records appear is decided by the current index, which is shown
  192. by the message on the title bar of the main display window.  Try this
  193. now, and you'll see the data for the next record come onto the screen. In
  194. Table View it appears underneath the previous record. In Form View it
  195. replaces the previous record.
  196.  
  197.  < Previous Record: This gets the previous record in the file, relative to
  198. the current record.
  199.  
  200.  >> Fast Forward:  Instead of moving forwards through the file one record
  201. at a time by pressing the Next button, you can move much quicker using the
  202. Fast Forward button.  Click on this button, and Superbase gets the next 
  203. records in the file, displaying them row by row until the screen is full,
  204. when it selects the Pause button.
  205.  
  206.  || Pause: When the Pause button is selected, you cannot select any menu
  207. item until you either release it or click on the Stop button next to it. You
  208. can, however, use the other Control Panel buttons. So, to view the next
  209. screen of records, release the pause by clicking on the Pause button.
  210. Superbase continues with the Fast Forward display of records, stopping when
  211. the next screen is full, or when it reaches the end of the file. Pause is
  212. useful when you're searching for a record and you want to stop from time to
  213. time to read the screen.
  214.  
  215.  << Rewind: This does the opposite of the Fast Forward button. You will see
  216. the data appear from the top of the screen,in reverse index order. If you do
  217. this immediately after Fast Forward there will be an apparent delay while
  218. Superbase displays records over the text of the existing display.
  219.  
  220.  |< First:  Pressing this button automatically displays the first record in
  221. the file, according to current index order.
  222.  
  223.  >| Last:  Pressing this button automatically displays the last record in
  224. the file, according to current index order.
  225.  
  226.  | Stop:  If you want to stop the Fast Forward or Rewind display, click on
  227. Stop.  You must also click on Stop if you want to interrupt Pause when it's
  228. selected.
  229.  
  230. OPENING FIELD TO VIEW
  231.  
  232. As Superbase imposes no limit on the number of fields per record, you need
  233. to have a way of restricting the fields that actually appear on the Main
  234. Display. You can do this with the Open Field option on the Project Menu.
  235.  
  236. Display the Project Menu, and select Open Fields. The basic procedure for
  237. selecting fields is very simple:
  238.  
  239. 1.  Click on a field name in the left-hand panel.  Superbase copies it
  240.     into the right-hand panel.
  241. 2.  Repeat until the selection of fields you want is in the right-hand
  242.     panel.
  243. 3.  Click on OK.
  244.  
  245. The list of fields in the right-hand panel is called the Open Fields List.
  246. Let's make one now.  Move the pointer onto the list of fields names, and 
  247. click on City.  Notice how Superbase copies it across.  Now click on
  248. Lastname.  When you have both names in the list, click on OK. (If you make
  249. a mistake, DEL removes the current field from the right-hand panel; Clear
  250. removes the whole list.) 
  251.  
  252. Superbase immediately returns to the Main Display showing the data for the
  253. two open fields. Try out the Control Panel buttons to see their effect.
  254. Experiment with Record View as well as Table View.
  255.  
  256. When you've finished, restore the full set of fields by selecting Close
  257. Fields from the Project menu.
  258.  
  259. PAGING
  260.  
  261. This is another feature which gives you control over the Main Display:
  262. the Paging option.
  263.  
  264. If Record View is not set, select it now from the Set Menu. Then go back
  265. to the Set menu, and move the pointer down to the Paging item, which should
  266. have a check mark against it.  Release the mouse button while Paging is
  267. highlighted. You've now turned the paging option off. (You can check this
  268. by looking at the Set menu again; there should be no check mark against the
  269. Paging item.)
  270.  
  271. Now, select the first record in the file by clicking on the First Record
  272. button. Then click on Fast Forward, and watch the display. You'll see that
  273. Superbase doesn't pause when the screen is full -- It just goes on
  274. displaying records. You can still use pause to halt the display, but the
  275. automatic pausing at the end of each "page" of data no longer occurs. The
  276. same applies when Rewind is in use, except that the records appear at the
  277. top of the screen.
  278.  
  279. If you now switch back to Table View and try out some of the Control Panel
  280. buttons, you'll see that with Paging off the difference is similar to that
  281. in Record View. Each record appears below the last, without clearing the
  282. screen. Rewind displays records from the top down, as in Record View.
  283.  
  284. MOVING COLUMNS
  285.  
  286. For this exercise you need to be able to see all the fields on the screen,
  287. not just those in the Open Fields list, so if you have an open Fields list
  288. in use, close it now by selecting Close Fields from the Project Menu.
  289.  
  290. You can see that if you have all the fields open in Table View, some of
  291. the field data is very likely to be hidden from view. Normally, to see
  292. hidden fields you have to scroll the screen to the right. However, Superbase
  293. provides a way of closing up columns to get more data on the screen.
  294.  
  295. Assuming you're in Table View -- set it if you're not -- click on the First
  296. button, then the First Record button on the Control Panel in order to get
  297. the first record of the Addresses file on your screen.
  298.  
  299. MOVING A COLUMN TO THE LEFT
  300.  
  301. Now move the pointer so that it is on the space to the right of "M" in the
  302. Title Field.  Once you have done that press and hold down the left-hand
  303. button of the mouse.  As you do this you will see two vertical lines
  304. appear, forming a column beneath the Title field. There are also lines
  305. extending off to the right of the screen.
  306.  
  307. Keeping the left button depressed, drag the pointer a little to the left,
  308. then release the mouse. You will see that the column moves, and when you
  309. release the mouse the data beneath the field name has shifted to the left.
  310. All columns to the right have also moved leftwards.
  311.  
  312. Now try the same with the Forename field. This time over the column so that
  313. it is just to the right of the "e" in Title. If you also try this with
  314. Lastname and Street you will see that as you move the columns over to the
  315. left the field name City appears on the right of the screen.
  316.  
  317. If you now move the City column to the left, the Code field will appear on
  318. the screen.  Finally, if you move the Code field, Country will appear on the
  319. right-hand side. So by moving the columns you've got all the fields on one
  320. screen instead of two.
  321.  
  322. Notice that you can move a column so that it overlaps the column to its left,
  323. truncating the data. This can be useful.
  324.  
  325. MOVING A COLUMN TO THE RIGHT
  326.  
  327. If you move a column back to the right, the truncated field name and data are
  328. not automatically restored to their full length. A quick way of restoring the
  329. length of a field is to double click in its column. Then if you click on the
  330. Current Record button the full field name and data will reappear. But as this
  331. only displays one record you will have to use Fast Forward if you want to
  332. redisplay a screen of Record data.
  333.  
  334. FORM VIEW DESIGN
  335.  
  336. Superbase allows you to rearrange the positions of the fields in Form View,
  337. setting more than one field on a line, creating columns of field to resemble
  338. invoices or other business forms, and generally talloring the system to
  339. suit your own application. The full 273 column woeksheet is available for
  340. Form View, and you can vary the depth by dragging fields downwards, creating
  341. new lines.
  342.  
  343. You can use Form View for creating new records and editing them, as well as
  344. for display. By setting the Printer option on, you can copy the visible
  345. portion of the worksheet to the printer.
  346.  
  347. Select Form View now from the Set Menu.
  348.  
  349. Make sure you've got the Addresses file open, and that the current record is
  350. the first record in the file.
  351.  
  352. DEFAULT FORM VIEW
  353.  
  354. If you look at the screen you can see that the fields names already appear
  355. in a Form View. This is the default Form, which we have predefined for this
  356. demonstration file.  You can change it, and then save it with Project
  357. Save File. Once a Form has been saved, the fields will appear in that
  358. layout every time you open the file.
  359.  
  360. MOVING FIELDS
  361.  
  362. Let's move the Lastname field to another position on the screen. Move the
  363. pointer so that it's on the field name Lastname.  Then press and hold down
  364. the left-hand button of the mouse.  Superbase outlines the field name and
  365. its data area. (If you see a cursor instead, you've started editing by
  366. mistake.  Carefully click again on the field name itself.)  Now drag the 
  367. outlined box to a new position two lines above its present position.
  368. Release the mouse button. As you can see, the field name and data have
  369. moved to this new position.
  370.  
  371. Now, if you want to, you can arrange the Form View for Addresses in any way
  372. you like. This can be just an experiment, but if you want to save the
  373. present arrangement, you can do so.  Select Save File from the Project
  374. Menu. Superbase stores the File Definition, which contains the Form View
  375. location of each field, on disk.
  376.  
  377. Although you have freedom to drag fields to any position on the screen,
  378. there are as usual a few limits to what you can do.
  379.  
  380. You cannot place a field on top of either the name or the data area of
  381. another field. If you try this, Superbase leaves the field you tried to
  382. drag in its original position.
  383.  
  384. Superbase won't let you move a field off the right or left-hand end of the
  385. worksheet.
  386.  
  387. To gain more lines, move a field down into the Control Panel. Then use the
  388. vertical scroll bar on the Main Display window to bring it back into view.
  389. Move it down again if you still need more lines.
  390.  
  391. To move a field over to the right of the worksheet, position it near the
  392. right-hand edge of the screen, then shift the display with the scroll bar,
  393. and drag the field further over.
  394.  
  395. Only the open fields are shown, so close the Open Fields List if you want
  396. to see all the fields in Form View.
  397.  
  398. Finally, a small but entertaining feature. Select Fast Forward, and drag
  399. the fields around as described above.  No problem.
  400.  
  401. SUMMARY
  402.  
  403. Time for a check list of what you should know before we proceed.
  404.  
  405. * How to open a file
  406. * How to switch between Form View, Table View, and Record View
  407. * How to switch Paging off and on
  408. * How to drag columns around in Table View
  409. * How to Open and Close a list of fields
  410. * How to select the Current record
  411. * How to move to the First record
  412. * How to move to the Last record
  413. * How to move to the Next record
  414. * How to go to the Previous record
  415. * How to use the Fast Forward to move forwards through the records
  416. * How to Rewind to move backwards through the file
  417. * How to Pause
  418. * How to Stop
  419.  
  420. Understanding all these actions is essential if you want to be able to work
  421. easily with Superbase. If you do not understand them or are uncertain then
  422. take a little time to go back and re-read the appropriate sections before
  423. continuing.
  424.  
  425. THE KEY LOOKUP BUTTON
  426.  
  427.  ? Key Lookup:  This is for the retrieval of individual records. You enter
  428. a value for the field on which the file is currently indexed, and Superbase
  429. uses the index to find and display the record. You can only use one index
  430. field at a time -- the Filter button is used for multiple value searching.
  431.  
  432. When you click on the Key Lookup button you'll see a requester for the
  433. entry  of a key value.
  434.  
  435. TYPING IN YOUR KEY
  436.  
  437. To be able to type in the box, you must move the pointer into it and click
  438. the mouse once. This produces the cursor, and you can then type in your
  439. Index Key. 
  440.  
  441. Suppose you want to find the record for Julie Kasper. The file is indexed on
  442. the Number field, so we can use the current index to search for individuals
  443. by their Reference Numbers. Click in the box and then type in "KAS0001"
  444. (omit the quotation marks).  This is the Index Key.
  445.  
  446. RETRIEVING THE RECORD
  447.  
  448. When you press Return or click on OK, Superbase looks up the first record
  449. for which the Number field has the value "KAS0001". If there were more than
  450. one with this value, you would have to browse through the file with the
  451. Next Record or Fast Forward button to find the exact record you wanted.
  452.  
  453. KEY LOOKUP WITH A DIFFERENT INDEX
  454.  
  455. You're not restricted to one index. Superbase allows you to have up to 999
  456. indexes for each file, all automatically updated when you add or modify
  457. records. We've provided indexes on the other fields besides the number
  458. field: Lastname, City and Country. Let's try one of these. Select Open index
  459. from the Project Menu.
  460.  
  461. Click on the field name Lastname; this is copied into the Selection Box.
  462. When you're ready, click on OK. You've selected the Lastname index, and if
  463. you look at the title bar at the top of the window you'll see that the
  464. message now reads "Superbase:  Addresses Indexed on Lastname".
  465.  
  466. The record on the main display has not changed. Click on the Key Lookup
  467. button, and Superbase produces the Record Key requester. As you did above,
  468. click in the box and type in a key value, only this time type in "Forge".
  469. Press Return or click on OK, and Superbase looks up the first record with
  470. Forge in the Lastname field.
  471.  
  472. ENTERING PARTIAL VALUES 
  473.  
  474. You don't even need to type the full index key in many cases. Try Key
  475. Lookup once more, but type in "Hut" and press Return. Superbase finds the
  476. first record for Huttermann.  For your information, Superbase tells you
  477. that it didn't find the exact match.
  478.  
  479. THE FILTER BUTTON
  480.  
  481.  = Filter:  This is a very powerful feature. You may have thousands of
  482. records in a database file, yet you may often want to review them (or print
  483. them out) on a selective basis. The Filter allows you to enter a set of
  484. values, as simple or a comprehensive as you like, to restrict the display to
  485. only the records that match those values.
  486.  
  487. THE FILTER REQUESTER
  488.  
  489. Move the pointer and click on the Filter button on the Control Panel. This
  490. requester looks more complex than the ones you have seen so far, but after
  491. a little practice with the demonstration file you'll find that you can
  492. remember how to use it easily. It's important that you learn how to use the
  493. Filter, because Superbase uses filters in several other functions.
  494.  
  495. The requester has four main parts: the Field Name Panel, the Operators, the
  496. Value Box, and the Main Box.  A Filter is created by a combination of
  497. clicking on field names and operators and typing in values. These actions
  498. produce the Filter Command Line in the Main Box. Let's look at each
  499. component of the Filter Requester in turn.
  500.  
  501. FIELD NAME PANEL
  502.  
  503. This appears on the left-hand side of the requester. You can scroll the
  504. list of field names up and down in the usual way, using the scroll bar and
  505. arrows at the right of the Field Name Panel. You specify that a field is
  506. to be used in the Filter by clicking on its name in this panel.
  507.  
  508. The list of field names is complete. It's not affected by whether you have
  509. an Open Fields List, so the fields that specify the Filter neen not be the
  510. same as the ones that are shown in the Main Display.
  511.  
  512. OPERATORS
  513.  
  514. These appear to the right of the Field Name Panel, and can be divided into
  515. the Relational Operators, Logical Operators and Mathematical Operators.
  516. We'll see how these are used below.
  517.  
  518. VALUE BOX
  519.  
  520. This is the box with the word "Value" next to it. You use it for typing in
  521. values such as names, numbers, and dates, which will form part of the
  522. Filter.
  523.  
  524. Always remember to press Return after typing in the Value Box. You must do
  525. this to ensure that the contents are copied to the Main Box.
  526.  
  527. MAIN BOX
  528.  
  529. This is the long box that appears below the Field Name Panel and extends
  530. across the whole requester. When you make selections with the mouse or type
  531. values into the Value Box, Superbase copies them into the Main Box,
  532. building up the Filter Command Line. In this way you get immediate feedback
  533. about the results of your selections. The maximum length of the Filter
  534. Command Line is much greater than the apparent length of the box -- up to
  535. 255 characters are allowed.  You can type directly into the Main Box, but
  536. in these exercises we'll stick to making selections with the mouse.
  537.  
  538. USING THE OPERATORS
  539.  
  540. The Operators are the most complex aspect of the requester. They are used
  541. to relate field names to other fields or values. For example, if we wanted
  542. to set up a Filter to show only the addresses in West Germany, we would
  543. need the expression: Country LIKE "West Germany". Here, Country is a field
  544. name obtained by clicking in the Field Name Panel; LIKE is selected by
  545. clicking on the LIKE Operator button; and "West Germany" is typed into the
  546. Value Box.
  547.  
  548. TEXT STRING AND PATTERN MATCHING:  LIKE
  549.  
  550. When you're searching for names or text strings, uyou should avoid using
  551. the equals sign operator, and use LIKE instead. This is because only LIKE
  552. accepts matches on either upper or lower case characters; it's said to
  553. be "case insensitive". The equals sign operator, on the other hand,
  554. requires exact matches for what you type in: It is "case sensitive".
  555.  
  556. LIKE also permits searches for text strings that include pattern matching
  557. characters. These allow you to enter incomplete words for the Filter. For
  558. example, to find all the records where the Lastname begins with "C" you
  559. need the Filter Command Line: Lastname LIKE "C". To specify a range add
  560. square brackets to the value:  Lastname LIKE"[A-D]*"; this finds all the
  561. records where the Lastname begins with "A", "B", "C", or "D". Note that
  562. the Asterisk is placed outside the brackets.
  563.  
  564. There are several other things you can do with the LIKE operator. You'll
  565. find a complete list and a number of examples in Appendix B.
  566.  
  567. THE RELATIONAL OPERATORS
  568.  
  569.  = This specifies that the field is to be EXACTLY EQUAL TO the following
  570. value or field:  Balance = 2000.
  571.  
  572.  <> The field is to be NOT EQUAL TO the following value or field: 
  573. Country <> "France".
  574.  
  575.  > The field is to be GREATER THAN the following value or field: Balance
  576. > 1000.
  577.  
  578.  < The field is to be LESS THAN the following value or field: Balance <
  579. 1000.
  580.  
  581.  >= The field is to be GREATER THAN OR EQUAL TO the following value or
  582. field:  Balance >= 1000.
  583.  
  584.  <= The field is to be LESS THAN OR EQUAL TO the following value or
  585. field:  Balance <= 1000.
  586.  
  587. THE LOGICAL OPERATORS AND, OR AND NOT
  588.  
  589. These provide links between different expressions like the ones given
  590. above. You use them to specify alternatives and ranges for the Filter,
  591. either for a single field or for a number of interrelated fields:
  592.  
  593.  AND Both of the conditions linked by AND must be satisfied for the record
  594. to be accepted by the Filter:  Country "West Germany" AND Balance  >=
  595. 5000.
  596.  
  597.  OR Either of the conditions linked by OR is sufficient to make the record
  598. acceptable to the Filter:  Country LIKE "West Germany" OR City LIKE
  599. "Geneva".
  600.  
  601.  NOT NOT is slightly different. It negates the effect of an expression:
  602. NOT (Country LIKE "West Germany" AND Balance > 5000). This will find all
  603. the records other than the ones where the country is West Germany and the
  604. balance is greater than 5000.  Note the use made of Parentheses with NOT.
  605.  
  606. PARENTHESES
  607.  
  608. The ( and ) operators are used in the normal way, to give priority to one
  609. part of the expression over another.
  610.  
  611. ( The following expression has a higher priority for evaluation than the
  612. preceding expression.
  613. ) Required to end a higher priority expression.
  614.  
  615. The numbers of opening and closing parentheses must be equal.
  616.  
  617. THE MATHEMATICAL OPERATORS
  618.  
  619.  + This is used to express addition:  Balance > Amount + 1000.
  620.  
  621.  - The minus sign expresses subraction:  Balance >  Amount - 1000.
  622.  
  623.  * The asterisk is used for multiplication:  Balance > Amount * 1.15.
  624.  
  625.  / The slash represents division:  Balance < Limit / 10.
  626.  
  627. TYPING IN THE MAIN BOX
  628.  
  629. The great power and flexibility of the Filter system is only achieved by
  630. giving the user control of every aspect of the operation. Because you
  631. type into the Main Box you include all kinds of expressions which are not
  632. available from the buttons on the requester itself, and all kinds of text
  633. and numeric values.
  634.  
  635. The price you pay for this flexibility is an increased risk of making
  636. mistakes. This is not too serious, as you cannot harm your data by using
  637. a Filter (although you can discard records using the Remove Records Filter).
  638. However, you may see a Superbase "Can't do this" message concerning an
  639. error in the Filter Command Line in two possible situations:
  640.  
  641.  When you click an OK after creating or editing a Filter Command Line.
  642.  
  643.  When you use a Filter after changing the definition of a field with
  644.  Project Edit.
  645.  
  646. If you see a "Can't do this" message you must either change the Filter
  647. Command Line or change the file definition. Here's a summary of the
  648. editing facilities available when typing inside the Main Box:
  649.  
  650. FILTER COMMAND LINE EDITING
  651.  
  652. You can remove everything from the Main Box by clicking on the Clear
  653. button.
  654.  
  655. If you have clicked in the box, hold down the Alternate Key and press X
  656. to delete its contents. (Note: we refer to this key combination as
  657. Alternate-X).  
  658.  
  659. Provided you have not left the box -- the cursor is still visible -- 
  660. Alternate-Q will restore the contents you deleted with the Alternate-X.
  661. This does not work after clicking on Clear.
  662.  
  663. If Superbase won't let you make an Operator selection when you return to
  664. modify an existing Filter Command Line, click in the Main Box and press
  665. Return. Now you can go ahead.
  666.  
  667. Shift key and cursor right arrow and shift key and cursor left arrow move
  668. the cursor to the end and beginning of the Filter Command Line
  669. respectively.
  670.  
  671. The DEL key romoves the character to the left of the cursor. Backspace
  672. repeats its action if held down.
  673.  
  674. USING A FILTER
  675.  
  676. The Filter Command Line is made active by clicking on OK. Whenever a Filter
  677. is in use, Superbase highlights the Filter button on the Control Panel. You
  678. can perform all but one of the Control Panel record selection operations
  679. we've discussed, and Superbase will restrict the records displayed to the
  680. ones that match the Filter values. For example, if you have specified the
  681. Country LIKE  "West Germany" and you click on the First Record button,
  682. Superbase will go and find the first record in the file, according to the
  683. current index, which has the value "West Germany" in the Country field.
  684.  
  685. The Key Lookup button is an exception to the filter effect. You can still
  686. recall individual records by entering an index key value, whether or not
  687. they  match the Filter.
  688.  
  689. SUSPENDING A FILTER
  690.  
  691. There wil be times when you want to remove the Filter effect so that you
  692. can review all the records in the file again. To do this, just click on the
  693. highlighted Filter button. It reverts to normal, and you'll find that when
  694. you use the Control Panel Superbase acts as if there were no Filter.
  695.  
  696. MODIFYING OR RE-ACTIVIATING A FILTER
  697.  
  698. If you've set up a Filter and then suspended it, you can bring it back into
  699. operation by clicking once more on the Filter button. Superbase displays the
  700. Filter requester, with the Filter Command Line in the Main Box just as you
  701. left it.
  702.  
  703. If you want to, you can add to the Filter Command Line by clicking on more
  704. field names and operators (you may need to click in the Main Box and press
  705. Return first), or edit it after clicking in the Main Box, as described
  706. above.
  707.  
  708. Whether you've made any changes or not, just click on OK to use the Filter
  709. again.
  710.  
  711. FIFTEEN MINUTE TUTORIAL
  712.  
  713. Make sure you've got the Addresses file open, indexed on Lastname. Set Table
  714. View with Paging off. Go into Project Open Fields and open these fields:
  715.  Forename
  716.  Lastname
  717.  Street
  718.  City
  719.  Country
  720.  
  721. In Table View, drag the Lastname column a few columns to the left, and then
  722. do the same for City, overlapping the Street column if necessary, until the
  723. Country column comes into view.
  724.  
  725. Click on the Filter button.
  726.  
  727. We are going to search for those name and address records where the person
  728. lives in the USA or West Germany.  So we'll use the Country field, and LIKE
  729. operator, and the Value Box.  You'll see the results of your selections
  730. appear as a Filter Command Line in the Main Box.
  731.  
  732. Move the pointer into the Field Names Panel, and click once on the down
  733. arrow to bring Country into view. Then click on Country. The name appears
  734. in the Main Box.  Next, move the pointer to the right and click on the
  735. LIKE button. This also appears in the Main Box. Now you must type in "USA".
  736. This goes in the Value Box.  Move the pointer into the Value Box and click
  737. on the mouse to produce the cursor. Type in "USA" (no quotation marks).
  738. Press Return -- this is essential, or the contents of the Value Box will
  739. not be copied into the Main Box. Your Filter Command Line should read:
  740.  
  741. Country LIKE "USA"
  742.  
  743. Next, you need the OR operator. Click on it and Superbase copies it into
  744. the Main Box. Now you must click on the Country field name again. This is
  745. important. A Filter Command Line like this is not allowed:
  746.  
  747. Country LIKE "USA" OR "West Germany"
  748.  
  749. So, click on Country, as before, followed by LIKE. Then, as before, click
  750. in the Value Box, and type in "West Germany". Press Return. Your Filter
  751. Command Line should look like this:
  752.  
  753. Country LIKE "USA" OR Country LIKE "West Germany"
  754.  
  755. If there are any mistakes click on Clear and repeat the steps above until
  756. you get it right.
  757.  
  758. You have built your Filter Command Line, so now you can put it into action.
  759. Click on the OK button. Superbase activates your Filter and displays the
  760. first record in the file that matches the Filter. Click on Fast Forward.
  761. Superbase shows all the records that match the Filter.
  762.  
  763. Now de-activate the Filter. Click on the Filter button so that it's not
  764. highlighted. Now click on Rewind. You'll see all the records in the file
  765. appear as normal.
  766.  
  767. Let's go back and add another condition. Click on the Filter button to
  768. recall the requester. Click on the OR operator, then on Country, then on
  769. LIKE, then in the Value Box, type in "France", and press Return. Your line
  770. should read:
  771.  
  772. Country LIKE "USA" OR Country LIKE "West Germany" OR Country LIKE "France".
  773.  
  774. Now click on OK and when Superbase shows the first record, click on Fast
  775. Forward. You will see that Superbase has added the addresses in France to
  776. the display.
  777.  
  778. That concludes our short tutorial.
  779.  
  780. OTHER FILTER BASED OPTIONS
  781.  
  782. You should have acquired a feel for the way the Filter requester works, and
  783. you can experiment freely with the Addresses file to deepen your knowledge.
  784. When you're ready, you can start using the Process options, all of which
  785. are selected from the Process menu.
  786.  
  787.  Remove: Allows you to delete groups of records from the file. You can use
  788. the Control Panel Filter to view them first -- the Filter Command Line is
  789. preserved for you to use in the other Filter functions.
  790.  
  791.  Import:  When you need to read in records from other systems, the import
  792. Filter provides a means of rejecting records that don't match the conditions
  793. you set up.
  794.  
  795.  Export: The opposite of Import, Export lets you create a disk file
  796. containing selected fields and records.
  797.  
  798.  Print:  A quick and easy way of obtaining a permanent list of all the
  799. information contained in the selected fields and records.